home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 8: LINUX Games / Linux Cubed Series 8 - LINUX Games.iso / games / x11 / strategy / xpuzzles.3 / xpuzzles / xpuzzles-5.3.1 / xdino / README < prev    next >
Text File  |  1996-04-08  |  7KB  |  185 lines
  1.     X-BASED DINOSAUR CUBE
  2.     =====================    Dino X widgets, V5.3
  3.  
  4.  
  5.     It has been tested on the following platforms:
  6.  
  7.     Sun4, SPARC        SunOS 4.1.3    X11R4
  8.     Sun4, SPARC        SunOS 5.4    X11R5
  9.     PC, 486            Linux 1.0.9    X11R5(*)
  10.     PC, 486            Linux 1.2.8    X11R6(**)
  11.  
  12.     *    Keypad 5 key may not work, in which case, try it with the
  13.     Num-Lock on
  14.     /usr/lib/X11/etc/xmodmap.std .  If not defined
  15.     **    Keypad may not work, since various keycodes may not be defined
  16.     by default.  Check that "KP_1 - KP_9, Home, Up, Prior, Left,
  17.     Begin, Right, End, Down, Next" are defined towards the end of
  18.     cp /usr/lib/X11/etc/xmodmap.std /usr/lib/X11/xinit/.Xmodmap
  19.     and then motify this or create your own at ${HOME}/.Xmodmap .
  20.     You should just have to uncomment them (get rid of some '!').
  21.     This should be done before X is started.
  22.  
  23.     If yours is not in this list, please let me know -- thanks. The
  24.     most updated source could be found on ftp.x.org under
  25.     /contrib/games/puzzles.
  26.  
  27. HOW TO BUILD?
  28.  
  29.     Do you have Motif?  If so, uncomment line 28 of Imakefile.
  30.  
  31.     It should be easy. Edit the Imakefile (or Makefile.std, see below)
  32.     for appropriate settings of variable SCOREFILE, then do:
  33.     xmkmf
  34.     make
  35.     xdino  [motif version will be xmdino]
  36.  
  37.     Note: if you don't have 'xmkmf' or the "Makefile" it generates
  38.     doesn't work well, edit Makefile.std for appropriate settings for
  39.     XINCLUDEPATH and XLIBPATH, then try:
  40.     make -f Makefile.std
  41.         xdino
  42.  
  43.     or if you have Motif, uncomment appropriate sections, then try:
  44.     make -f Makefile.std all.xm
  45.     xmdino
  46.  
  47.     You should have Dino.ad copied to $(HOME)/Dino or 
  48.     /usr/lib/X11/app-defaults/Dino to run, especially if the background
  49.     is similar to one of the faces. Edit this file for your preferences.
  50.     You might want to move xdino into /usr/bin/X11 (or wherever your
  51.     X binaries are).
  52.     You might also want to move xdino.man to /usr/man/man6/xdino.6
  53.  
  54. ANYTHING SPECIAL IN USING?
  55.  
  56.     Click on the left mouse button to move a piece.  Release it on an
  57.       adjacent piece on the same face.  The puzzle will then turn
  58.       towards where the mouse button was released.
  59.     Click on the middle mouse button toggle the practice mode. (This is
  60.       good for learning moves).  Also 'P' or 'p' does the same thing.
  61.       One must double click on the middle mouse button if the puzzle is
  62.       being worked on.
  63.     Click on the right mouse button if you want to randomize the puzzle.
  64.       Also 'R' or 'r' does the same thing.  One must double click on
  65.       the right mouse button if the puzzle is being worked on.
  66.     'O' or 'o' to toggle orient mode.
  67.     '2' (not the keypad 2) to set period 2 mode.
  68.     '3' (not the keypad 3) to set period 3 mode.
  69.     'B' or 'b' to set both period 2 and period 3 mode.
  70.     'S' or 's' to auto-solve.  Unfortunately, its unimplemented.
  71.     'U' or 'u' to undo last move.
  72.     'G' or 'g' to get a saved puzzle.
  73.     'W' or 'w' to write or save a puzzle.
  74.     'Q', 'q', or Control-C to kill program.
  75.  
  76.     Key pad is defined for 2d dino as:
  77.     7   8   9
  78.         ^
  79.     3 <   > 6
  80.         v
  81.     1   2   3
  82.  
  83.     The key pad along with the use of the mouse will allow you to move
  84.     the cube i.e.,
  85.     KP_7=>TopLeft        KP_8=>Top     KP_9=>TopRight
  86.     KP_3=>Left                      KP_6=>Right        
  87.     KP_1=>BottomLeft  KP_2=>Bottom  KP_3=>BottomRight
  88.     Note: Top, Left, Right, and Bottom only work when the control key
  89.     is pressed and there is no analog for 3d dino.
  90.  
  91.     Key pad for 3d dino, use your intuition (is this a cop out or what?).
  92.     The key pad is defined differently depending on which side of the cube
  93.     your mouse is pointing at.
  94.  
  95.     The alt keys will allow one to move the center of the cube.  The
  96.     2 opposite corners do not move.
  97.  
  98.     The shift keys will allow one to access "Period 2" turns from "Both"
  99.     mode, otherwise it assumes "Period 3" turning. Edges turn in
  100.     "Period 2" and corners  turn in "Period 3".  The "Period 2" mode has
  101.     extra cuts around the faces.
  102.  
  103.     The control key allows you to move the whole cube at once without
  104.     being entered as a move.  Hold down the control key while using the
  105.     left mouse button or the keypad.
  106.  
  107.     Try resizing the cube. Notice the puzzle resizes to take advantage
  108.     of the "room" available.
  109.  
  110.     The title is in the following format (non-motif version):
  111.     xdino{2|3}d.{2|3|both}: (<Number of moves>/\
  112.         {<Record number of moves>|NEVER|PRACTICE}) - <Comment>
  113.     {2|3}: current dimensional view
  114.     {2|3|both}: current turning mode or both modes.
  115.     {<Record...}: puzzle is either in practice mode or record mode
  116.        In record mode, if there is no record of the current puzzle, it
  117.        displays "NEVER".
  118.  
  119.     If you were looking for a auto-solver, sorry.  If you know of one
  120.     let me know.
  121.  
  122.     Also a tesseract (4D cube) would be nice. (Does such an analog exist
  123.     for 4d?)
  124.  
  125.     Personally, I have solved "Period 3" mode using this program.
  126.     The "Period 2" mode was suggested by Derek Bosch <bosch@sgi.com>.
  127.     The physical puzzle ("Period 3") is now available.  It is called
  128.     a Triangle - 4 Cube - Dinosaur with colored dinosaurs on it, (or
  129.     Triangle - 4 Cube - 6 Colors with solid colors, (a 4 color and a 
  130.     2 color are also available with point oriented coloring)).
  131.  
  132.     Refer to the man page for detailed command line options.
  133.  
  134.     If you want further information on puzzles, I'll be glad :-) to send
  135.     it to you.
  136.  
  137. SAVE FORMAT
  138.  
  139.     The format is not standard.  The reason is that this is simple to
  140.     produce.  The format will probably change to become more readable.
  141.     Consider the 2d cross representation:
  142.  
  143.     practice: 0 false, 1 true
  144.     moves: 0-MAXINT
  145.  
  146.     startingPosition:
  147.       0       R     where the starting unrandomized faces would be,
  148.     1 2 3   Y W G   each face has 4 corners
  149.       4       O     if orient mode, orientation number follows face number
  150.       5       B       0 up, 1 right, 2 down, and 3 left.
  151.  
  152.     This is then followed by the moves
  153.     move #: face corner direction control
  154.       each turn is with respect to a corner on a face.  The corners
  155.       start at the upper right and work clockwise.
  156.     Direction is represented as 0 upper right, 1 lower right, 2 lower
  157.       left, 3 upper left, 5 clockwise, 7 counterclockwise, 8 up, 9 right,
  158.       10 down, and 11 left.
  159.     Style is represented as 0, 1, or 2, 0 if just a corner is rotated, 1
  160.       1 if the center of the cube is moved, and 2 if a period 2 twist.
  161.     Control is represented as 0 or 1, 1 if the whole cube is moved at once
  162.       (here i and j do not matter), 0 if not.  The xdino record keeper
  163.       does not count a control move as a move, but here we do.
  164.  
  165.     Caution: the program may crash on corrupted input.
  166.  
  167. FOUND A BUG?
  168.  
  169.     Send bugs reports and fixes to the author. For bugs, please include
  170.     as much information as to their location as possible, since I may not
  171.     have the resources to duplicate the them.
  172.  
  173.     David Albert Bagley,    bagleyd@hertz.njit.edu
  174.  
  175. HISTORY
  176.  
  177.   [Apr 08, 96]    V5.3: Minor changes.
  178.   [Jan 31, 96]    V5.2: Puzzle can now moved by a more intuitive drag and
  179.         drop approach.  Pieces will invert, when selected.
  180.   [Dec 15, 95]    V5.1: Minor updates, RNG for 32/64 bit, border color
  181.         to make faces look more realistic.
  182.   [Oct 06, 95]    V5.0: Xt/Motif, your choice.
  183.   [May 16, 95]    V4.10: Xt version.
  184.   [Jun 06, 95]    V4.10.1: Period 2, Both and Orient modes added.
  185.